Синхронизация и интеграция динамического справочника ошибок в мобильном приложении

Запрос справочника при холодном старте, безопасный парсинг JSON-контракта и подмена алертов в UI.

Author

Services Task & Simulation Framework Documentation

Published

July 13, 2026

Краткая карточка задачи

Репозиторий / Компонент: mobile-app (Клиентское приложение iOS / Android).
Категория: Фронтенд.
Взаимодействие: Вызов внешнего HTTP GET /api/v1/auth/error-directory.
Статус: Готово к реализации

Ограничение публичной документации

В открытом доступе представлена демонстрационная версия задачи. В настоящей публичной документации отображены не все шаги, технические сценарии и приватные эндпоинты для системы цифровых симуляторов бизнес-процессов.

Полная спецификация метода: Доступна только во внутреннем контуре разработки (Confluence / Swagger Enterprise).
Для получения доступа: Обратитесь к системному аналитику или Product Owner вашей команды.

Инструкция по шагам:
1. На Шаге 1 (Логика Холодного старта): Встроить триггер вызова метода GET /api/v1/auth/error-directory в общую цепочку инициализации приложения (при холодном старте или успешном обновлении сессии). Обязательно передавать в заголовках текущую системную версию сборки (X-App-Version) и локаль устройства (app_lang) в качестве Query-параметра.
2. На Шаге 9 (Безопасный парсинг и обработка сбоев): Обернуть блок парсинга полученного JSON в try-catch. При возникновении исключения JsonUnsupportedObjectError (если структура ответа повреждена или нарушена её схема), гасить ошибку в фоне, отправлять лог сбоя в Crashlytics и автоматически переключаться на использование встроенного в сборку хардкод-файла локальных ошибок, чтобы полностью предотвратить крэш интерфейса.
3. Интеграция в State Manager: При успешном чтении JSON-реестра, загрузить полученную карту соответствий (где ключом является canonical_code) в оперативный стейт-менеджер приложения (ErrorDirectoryStore).
4. UI Динамический маппинг: Переписать глобальный перехватчик (интерцептор) ошибок пользовательского интерфейса. При получении любой бизнес-ошибки с бэкенда, UI-компонент (диалоговое окно, алерт или сниппет ввода) должен сначала обратиться в локальный ErrorDirectoryStore по коду ошибки, считать оттуда свежий localized_text / ui_reaction и динамически отобразить актуальный текст и подсказку, не требуя новой публикации приложения в сторах.